Amiga Tools 5/Amiga Tools 5.iso/tools/dfÜ/gotcha/docs/gotcha.doc

Text File | 1996-03-30 | 117.1 KB | 3,535 lines

                                    Gotcha


                                   Version
                                     1.1




                                Thomas Bickel



                                  1995/1996
















                         Generated with Heddley v1.1
                      Heddley v1.1 (C) Edd Dumbill 1994






































                                  - Page 1 -



1.    Gotcha! v1.1



                                  GOTCHA!

                             Version 1.2 beta 2

            Copyright 1995/1996 Thomas Bickel; All rights reserved.



   Requirements               What you need for fun
   Limitations                Unregistered version limitations
   Introduction               About Gotcha!
   Basic Information          How it works and how to use it
   Keywords                   The keyword index

   The Support Echo           Infos about the Gotcha support echo
   Contact the author         ! changed ! How to get in touch with the author
   Legal stuff                Licence agreement, disclaimer and other stuff
   Bug Reports                If you find a bug read this
   Acknowledgements           Acknowledgements
   Registration Form          Registration Form

2.    Limitations


   Unregistered Version Limitations
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   First of all the unregistered version will open a little window
   each time you start it. You can close this window after a few seconds
   by clicking on the 'OK' gadget.

   In addition to that the unregistered version has limits on how many calls
   it can make (outgoing and incomming). After five or six connections
   Gotcha will sooner or later quit.

3.    Registration Form


                          Gotcha Registration Form
                          ~~~~~~~~~~~~~~~~~~~~~~~~

Name:    ______________________________________________________

Address: ______________________________________________________

         ______________________________________________________

Country: ______________________________________________________

Network-Addresses:  ______________________________________________________

                    ______________________________________________________

Computer Type:      A __00

Processor:          680___

Kickstart Version:  ______

Comment:            ______________________________________________________

                    ______________________________________________________


                                  - Page 2 -
3.    Registration Form

                    ______________________________________________________

                    ______________________________________________________

Price List:

   Austrians:           200 öS
   Rest of the World:   30 DM or 25 US$ or 15 UK£

   NOTE: Only Euro(!)cheques and cash will be accepted as payment.


Send this form along with the money to:
      Thomas Bickel
      Effingergasse 10/12
      A-1160 Wien
      Austria / Europe

4.    Introduction


   Features                 A short list of some features
   Installation             Some infos about the config file
   Point Setup              How to setup Gotcha for a Point system
   Node Setup               How to set up Gotcha for a node
   The Modem                What you need and how to set it up
   The Nodelist             What is that?
   Custom Configs           Set up configs for certain nodes only

5.    Bug Reports


   If you find a bug in Gotcha or one of the tools it would be quite nice
   if your sent a bug report.

   If you send a bug report please give as much information as possible.
   Something like "Gotcha crashes, please fix it" does not help at all,
   there are lots of possibilities.

   In addition to a exact description of the bug plus the circumstances
   it happens in, give the following informations (if you can):

   What version of Gotcha are you using?
   Are you a registered user?
   What hardware are you using (CPU, memory, modem)?
   What patches are installed?
   Can the bug be reproduced on other amigas (models,configurations)?

   The config file could be a help too (if it's Gotcha or GList that's
   buggy). And if the log shows something: Send the important parts.

6.    Gotcha Echo

                         ___  ___ _____ ___ _   _  ___
                        / __|/ _ \_   _/ __| |_| |/ _ \
                       | (_ | (_) || || (__|  _  |  _  |
                        \___|\___/ |_| \___|_| |_|_| |_|

An echo setup to support and promote the Gotcha Amiga FTN mailer by Thomas
Bickel. Echo name GOTCHA, available from:

 2:259/15  - Home of the echo
 2:259/26  - HUB, 259 NEC
 2:259/66
 2:250/366
 2:250/347 - HUB
 2:25/53   - MNL

                                  - Page 3 -
6.    Gotcha Echo

 2:442/403 - MNL

(Any other systems please let me know...)

For a feed contact 2:259/15

Also available is the related GOTCHA_AMY echo on Amiganet.

Lee Kindness, Trumpet Blower, [e-mail] Moderator of GOTCHA,
GOTCHA_AMY.

7.    Features


   So what is this anyway....

   Gotcha! is a mailer for nodes and points, meaning it will send out
   and recevice mail and other files.

   Features:   * Does Hydra, DirectZap, ZedZap, ZedZip
               * EMSI and WaZoo handshakes
               * Is 5D aware
               * Makes use of the nodelist
               * Handles fax and voice calls
               * Tons of ARexx commands
               * Uses OwnDevUnit.library
               * Can hande more than 1 call at a time
               * Is a commodity
               * It's Faaaaaaaaaaaast......
               * Features Autoselect
               * Comes with a trapdoor.cfg converter

8.    Installation

 Gotcha is a CLI based application and can therefore not be run from
Workbench. It accepts a large number of keywords that can either be set in a
configuration file or passed as CLI-arguments.

Upon invocation Gotcha will look for it's configuration file "Gotcha.config"
in your "mail:" drawer. This file should contain you defaut settings, but
should at least contain the BBS, ADDRESS and AKAS (if you have any)
parameters. Points should also specify BOSSNUMBER and PASSWORD.

If you need different settings from what you specified in the configuration
file you can either create another config file and pass its' name as a cli
argument or list the parameters you wish to change as cli arguments.

To tell Gotcha to use a different config file use the CONFIG keyword. E.g:
Gotcha CONFIG mail:gotcha.cfg2

To use no config file at all use: CONFIG "". If you do not use a config file
then where possible default values will be used for all parameters, but you
will need to specify other personal parameters as e.g. ADDRESS.

The following CLI command MAY be enough if you are only a point: Gotcha CONFIG
"" BBS "Point Prince" BOSSNUMBER "1-800-123456789" ADDRESS "1:273/69.69"
PASSWORD "slayer"

9.    Point Setup

 To set up Gotcha for a Point system just follow this steps:

   1. Copy the files to their apropiate directories.
      All libraries to libs: The executables to a path where they will
      be found, the other files where you want them.

   2. If you don't already have a mail directory and a "mail:" assign

                                  - Page 4 -
9.    Point Setup

      create a new subdirectory and assign mail: to it, then create
      the two subdirectories "mail:inbound" and mail:outbound".

   3. Copy a example config to your mail: directory and rename it to
      "Gotcha.config" or leave out this step and create a new file
      with your text editor.

   4. Use GConfig (from the Gotcha archive) or a text editor to change
      change the configuration file to suit your needs.
      Most important keywords are BBS, SYSOP, ADDRESS, BOSSNUMBER,
      and PASSWORD.
      Depending on your modem and serial device setup you might have
      to change some things there too.
      Make sure the ANSWER keyword is either not present or set to NO
      (ANSWER = NO).

   5. That's it power up your modem and type "Gotcha" to call your boss.

10.    Node Setup

 A node is more complicated to set up than a point. Follow the steps listed in
the Point setup section but set leave out the BOSSNUMBER parameter and set
"ANSWER = YES". You will also need to set other keywords which are important
for nodes. In addition to that you will need to create a nodelist directory
and assign "nodelist:" to it (and set NLDIR = "nodelist:"). Have a look at the
GList docs and compile the nodelist.

The main idea in a node setup is to have Gotcha make outgoing calls to deliver
and receive mail and receive incomming calls. Since people don't want to sit
in front of there computers all day (and night long) the task of managing
outgoing calls is accomplished by the use of GPoll, a utility that will scan
your outbound directory for files (mail most of the time) that need to be
delivered and tell Gotcha to call those nodes, and a cron utility. A Cron
utility is a tool that executes other programms at certain times.

Gotcha will make outgoing calls if it receives a Rexx "CALL" command (and
that's exactly what GPoll will do if it detects a file that needs to be
delivered: send Gotcha a CALL command). Unlike some other mailers Gotcha does
not only handle one number (or address) at a time but multiply numbers. E.g.
with "CALL 2:310/108!39:23/5" Gotcha will first call 2:310/108 and then
39:23/5. If one of the calls fails, i.e. if the line was busy or the session
could not be completed successfully, Gotcha will wait REDIALDELAY seconds and
then retry to to call the system or get a successful session. This will happen
as many times as specified with the RETRIES keyword. Numbers will be removed
from the call-list if the modem reported anything else than BUSY after the
dialstring was sent to it or if the session was successful. The Number will
also be removed if you specified NORETRYHANDSHAKE and the handshake failed.

While waiting for the redialdelay to elapse Gotcha is able to receive
incomming calls. Also if there was already a CALL command sent to Gotcha,
other CALL commands  will be accepted and the new numbers appended to those
received in previous  CALL commands.

11.    The Modem

 Your modem must be Hayes compatible and be configured in a way that
returncodes (such as BUSY, NO DIAL TONE, CONNECT, etc.) are given in words and
not as numbers (verbal/numeric mode), CONNECT responds from the modem must
include the connection speed (i.e. modem to modem speed). If your modem
supports the CARRIER keyword, the CONNECT message is expected to include the
computer to modem speed and the CARRIER message should report the modem to
modem speed.

Be sure to set up your modem in a way that dropping DTR causes the modem to
hang up. If this is not the case Gotcha will not be able to hang up in most
cases! This can be achived with AT&D2 on most modems.


                                  - Page 5 -
11.    The Modem

You will also need a seven-wire cable.

Slow modems: Some modems require a delay between AT and the rest of the
command. If this is the case with your modem place one or two tilde(s) ("~")
after the AT wherever you use it in. e.g MODEMINIT "AT~~Z|"


Example USRobotics Courier HST Dual Standard V.34+ Settings:

   B0  C1  E1  F1  M1  Q0  V1  X7
   BAUD=57600  PARITY=N  WORDLEN=8
   DIAL=HUNT   ON HOOK   TIMER

   &A3  &B1  &C1  &D2  &G0  &H1  &I0  &K1  &L0  &M4  &N0
   &P0  &R0  &S0  &T5  &X0  &Y1  %N6

   S00=000  S01=000  S02=043  S03=013  S04=010  S05=008  S06=002  S07=060
   S08=002  S09=006  S10=007  S11=070  S12=050  S13=000  S14=001  S15=000
   S16=000  S17=000  S18=000  S19=000  S20=000  S21=010  S22=017  S23=019
   S24=150  S25=005  S26=001  S27=000  S28=008  S29=020  S30=000  S31=000
   S32=009  S33=000  S34=000  S35=000  S36=000  S37=000  S38=000  S39=000
   S40=000  S41=000  S42=126  S43=200  S44=015  S45=000  S46=000  S47=000
   S48=000  S49=000  S50=000  S51=000  S52=000  S53=000  S54=064  S55=000
   S56=000  S57=000

12.    Nodelist


 What is it

A nodelist is a text-file which contains (lists) all nodes of a certain
Network (FidoNet, AmigaNet, etc). It stores various informations about each
node, such as the sysops name the location and phonenumber. Gotcha can make
use of the information stored in the nodelist, e.g look up a nodes
phonenumber. To keep up with changes (e.g new nodes, changed phonenumbers) so
called nodediffs are used. These files are much smaler than the nodelist
itself and contain informations on how to change the nodelist to get it up to
date.


 How to use it

To use a nodelist with Gotcha you need to compile it with GList. Have a look
at the GList docs for more informations. GList will also create the latest
nodelists from the old one and the latest nodediff(s).

Points usualy don't need a nodelist since they only call one or two numbers
and those can easily be stored in Gotchas config file.

13.    Custom Configurations

 For certain nodes you may want to set up a special configuration, for example
if you regularly call a node that cannot handle EMSI you will want to turn it
off to speed up the session handshake.

Gotcha (or rather GList) allows you to set up such special configurations for
nodes. So to turn off EMSI for say 1:300/999 you just have to specify

setconfig 1:300/999 "NOEMSI YES"

in "glist.config".

More than one entry for a node is OK too. You can also specify a pattern so if
you want to use a different aftersession script for AmigaNet you could
specify:

 setconfig 39:* "AFTERSESSION s:amiganet.bat"

                                  - Page 6 -
13.    Custom Configurations

 setconfig 40:* "AFTERSESSION s:amiganet.bat"
 setconfig 41:* "AFTERSESSION s:amiganet.bat"

To list all or parts of your custom configurations use the "showxconfig" tool
that comes with Gotcha.


For more informations on custom configurations have a look at the GList docs.

14.    Basic Information


   Forbid and Pickup     How to (not) get what you (don't) want
   The Keyboard          Alt and Function key assignment
   The Menu              Explaines that
   Fax and Voice         Fax and Voice support
   ARexx                 The ARexx port
   Dial Scripts          Dial script examples
   Call options          More about the CALL command
   Multiple Lines        Use it in a multiline enviroment
   OwnDevUnit Library    Gotcha supports it
   Config Commands       Some format infos
   Embedded %-commands   A list of those
   Modem strings         Special characters in modem strings explained
   Commodity Infos       Horay! It's a commodity
   Filenames             2D and 4D filenames
   Flow Files            Explains these
   Compressed Mail files Filename format and when they are sent
   Outbound file tagging Filenote tags for outgoing files
   Inbound file tagging  Filenote tags for outgoing files
   Filename bumping      Bumping filenames in the inbound directory

15.    Forbid and Pickup

 EMSI handshake allows the setting of certain flags that tell the other system
what to send and what not to send. The features described here will only work
if the handshake used at session startup was EMSI. Note that Gotcha can only
ask the other system no to send certain files, the remote system may ignore
our wishes.

With setting the PICKUP keywords Gotcha can be configured to ask the other
system to - send files for all addresses (primary and akas)
          - send files for the primary address only
          - send no files at all
 These are calling system options.

With the FORBID keywords Gotcha can be configured to tell the remote system to
NOT send - file requests
         - compressed mail
         - all of the above
 These are called system options.

The default is to receive and send everything (except filerequests if there is
no requesthandler installed).

16.    Keyboard

 Gotcha has some nice features controlled with the keyboard.

Esc     ... If Gotcha is idle in answer mode Esc will reset the modem i.e.
            send the MODEMINIT string to the modem. In a session Esc will
            abort the session as soon as possible. This has about the same
            effect as turning off your modem.

Alt-A   ... Answer the phone. Gotcha will react as if the number of RINGs
            specified with the RINGS keyword had been received.


                                  - Page 7 -
16.    Keyboard

Alt-Q   ... Quit. Gotcha will abort a possible redialdelay and exit.

Alt-X   ... the same as Alt-Q

Alt-R   ... Reset modem

Alt-S   ... Toggle SHOWREXX. i.e. (don't) show received Rexx commands.

Alt-W   ... Abort a redial. i.e. remove all numbers that would be called
            after the redialdelay time had elapsed from the list.

HELP    ... Show some information. Such as keyboard information, settings and
            functionkey settings

In addition to those above 'Cursor Up' will bring up a little window with a
string gadget. Strings entered in that window will be sent to the ARexx port
shown in the second gadget, right below the stringgadget. Make sure that you
specify only ARexx ports as a destination or you might crash your Amiga.

There are also standard <left Amiga> keys for available for most of the listed
functions.

Function keys: Strings assigned to function keys via the FKEY and SFKEY
keywords will be sent to Gotchas ARexx port. So something like
 FKEY1 "NOEMSI NO"
 FKEY2 "NOEMSI YES"
 FKEY3 "RUN GPoll" is possible since NOEMSI and RUN are ARexx commands. See
the keywords section  for a list of all ARexx keywords.

17.    The Menu


 Project
 ----------------------------
 | Answer Phone             | Act as if an incomming call had been detected
 |                          | and send the MODEMANSWER string to the modem.
 |                          |
 | Toggle ShowRexx          | Will toggle the SHOWREXX setting
 |                          |
 | Reset Modem              | Will cause the MODEMINIT string to be sent to
 |                          | the modem
 |                          |
 | Redial Abort             | Will abort a redial, while in waiting for
 |                          | the REDIALDELAY to expire, in ANSWER mode.
 |                          |
 | Abort Session/Reset Modem| Resets the modem, or if in a session aborts
 |                          | the session.
 |                          |
 | Informations...          | Will show some infos
 |                          |
 | Arexx sender...          | Opens a window which lets you send ARexx
 |                          | commands
 |--------------------------|
 | Iconify                  | If Workbench is open this will iconify Gotcha.
 |--------------------------|
 | Hide                     | This will close the window, and is the same
 |                          | as iconify, except that there is no icon.
 |--------------------------|
 | Quit                     | Quit Gotcha
 ----------------------------

 Tools
 ----------------------
 | Poll...            | A built in version of GPoll
 |                    |
 | FReq...            | A built in version of GFreq
 |                    |

                                  - Page 8 -
17.    The Menu

 | NodeInfo...        | Will open a requester that lets you browse throught
 |                    | the nodes of all compiled nodelists.
 ----------------------

 Settings
 ----------------------
 | General...         | Edit settings such as SYSOP, ADDRESS, AKAS, etc
 | Modem...           | Edit the modem settings
 | Modem RC...        | Edit modem result codes settings
 | IO...              | Edit I/O settings
 | BBS...             | Edit BBS settings
 | Commands...        | Edit the command settings
 | Display...         | Edit display (screen, window, log,...) settings
 | Flow Control...    | Edit session flow control settings
 | Function Keys...   | Edit function keys settings
 |--------------------|
 | Save...            | Save current settings
 ----------------------

 F1-F12
 ----------------------
 |                    | Whatever you set FKEY1, FKEY2, etc to will be
 |                    | shown here.

 SF1-SF12
 ----------------------
 |                    | Whatever you set SFKEY1, SFKEY2, etc to will be
 |                    | shown here.

18.    Fax and Voice

 Fax and Voice support

If your modem supports fax and/or voice connects you can configure Gotcha in a
way that it will spawn external commands if a voice or fax connection is
detected. To do so you will have to set MRC_FAX and MRC_VOICE to what your
modem  reports if such an connect is made and FAXCOMMAND and VOICECOMMAND to
what  you want to be executed. FAXCOMMAND and VOICECOMMAND both may contain
embedded %-commands the  %?-command can be used to launch different commands
depending wether it was  an incomming or outgoing call.

19.    ARexx

 ARexx

Gotcha features an powerfull ARexx-port which allows easy control over Gotcha.
While in answermode Gotcha will, except for the session handshake and for
outgoing calls the time after the dialstring has been sent to the modem,
always accept ARexx commands, even if it's just in a session and transfering
files.

The port name will, if not changed to something else with the REXXNAME
keyword, default to "GOTCHA". If a port with the given name already exists
Gotcha will add a dot and a number to the name and keep increasing the number
until it is able to create a unique portname. I.e. if you invoke Gotcha three
times with the default name unchanged the port names will be "GOTCHA",
"GOTCHA.1" and "GOTCHA.2".

Nearly all commands that can be given in a configuration file can be sent to
the ARexx port and will be understood. Exceptions are: BUFFEREDLOG, ANSWER,
QUIET, REXXNAME, CX_POPKEY, CX_PRI and LOGLINES. If you need to change one of
those you will have to terminate Gotcha and restart it with the new setting
either as cli-argument or in a config file. In addition to those several other
ARexx-only commands can be used to ease the writting of ARexx-programms.

NOTE: Serial parameters should only be changed while Gotcha is idle. Ie not
making or receiving a call.

                                  - Page 9 -
19.    ARexx


The most important ARexx command certainly is "CALL" which will make Gotcha
call one or more nodes. There is an extra section that describes more detailed
all possibilities "CALL" has.

"GETCONFIG" will be quite handy if you need to change some settings but can
not be sure what the current configuration is. Say you need to change the
VOICECOMMAND:


OPTIONS RESULTS

ADDRESS "GOTCHA"

"GETCONFIG VOICECOMMAND"    /* get the configuration string */

oldcom = RESULT

...                         /* do what you need to do here */

oldcom                      /* and set back the old setting */


See the section about dial scripts for some more ARexx information.

A small tool called GTell that comes with Gotcha may help you with sending
ARexx commands. e.g 'GTell "call 123"' is the same as  ' rx "ADDRESS
'GOTCHA';'call 123'" '.
 See the GTools.guide for more information on GTell.

20.    Dial Scripts

 Dial Scripts

If you need to do more sophisticated dialing or want to use Gotcha as a
dial-up tool to some other service you will need to write a ARexx script that
will dial out and that tell Gotcha to start the file transfer. Something like
this should work:

------------------------------------ cut --------------------------------
 ADDRESS "GOTCHA"
 OPTIONS RESULTS
 SIGNAL ON FAILURE
 OPTIONS FAILAT 4        /* Gotcha will WARN if there's something wrong */

 UNLISTEN                /* so Gotcha can't interfere */
 RESET                   /* reset the modem */

 STIMEOUT 70             /* timeout is 70 secs for connection */
 'SMODEM AT~DT1234567|'  /* dial */

 SWAIT "CONNECT"         /* and wait until we're connected */
 SLINE
 line = RESULT;

 say "CONNECT" line;     /* show the speed */

 STIMEOUT 25             /* set the timeout to 25 secs */

 SWAIT "login:"          /* wait for prompt */
 SWRITE "Dan Aykroyd"||d2c(13)  /* send the name */
 SWAIT "password:"
 SWRITE "John Belushi"||d2c(13)

 SWAIT "connection ok"

 STARTSESSION            /* and start the session */

                                 - Page 10 -
20.    Dial Scripts

 LISTEN                  /* realy! */

 EXIT

 FAILURE:
 say "Could not connect"
 EXIT

------------------------------------ cut ------------------------------

21.    Call Options


   Gotcha has the ability to call more than one number at one time.
   I.e. you don't have to first tell Gotcha to call a number check wether
   Gotcha has made the call and then tell Gotcha to call the next number
   but you can specify a list of numbers Gotcha will call.

   Numbers have to be seperated with a '!'.
   E.g. CALL "2:310/0!2:310/108!39:23/5!2:310/26" would first call 2:310/0
   then 2:310/108 and so forth.

   Gotcha will try to call the number, if the line is BUSY Gotcha will skip
   to the next number, if a connect is made a handshake will be
   attempted. If in this phase the modem responds with something else than
   a BUSY or a CONNECT/CARRIER string the number will be removed from the
   list.
   If the handshake failes and NORETRYHANDSHAKE is YES the number will
   be removed from the list, else Gotcha will just skip this number,
   try to call again later and continue with the next number.
   If the session is successful the number will be removed from the list
   else it will be skiped.

   If all numbers in the list have been called and there are retries left
   Gotcha will wait RETRYDELAY time and then attempt to call the number that
   were not removed on the last attempt. This will happen as many times
   as specified with the RETRIES keyword.

   Even if Gotcha is already busy calling numbers, i.e. if you already sent
   a CALL string to Gotcha and there are still numbers left to call from
   that previous CALL-command, new CALL commands can be sent to Gotcha.
   Those new numbers will be appended to the list of numbers to call.
   The number of numbers Gotcha can manage is aprox. 80.

   Akas will be removed too. If you call 1:2/3 AKA 4:5/6 with a
   CALL "1:2/3!4:5/6" both numbers will be removed from the list after
   a successful session (and if the other side tells Gotcha about the
   AKA).

22.    Multiple Lines


   Gotcha can be used without any problems on multiple lines.
   Using it with an multiline BBS is no problem.

   It is recomended to make Gotcha resident if you intend to use it more
   than once at a time. This will help to save some memory. The "r"
   attribute will have got lost during archiving with lha but Gotcha has
   been compiled with a special resident header and can therefore be made
   resident with the cli "resident" command.
   E.g "resident mail:bin/Gotcha".

   Gotcha will take care that its ARexx portname is unique but if you
   want to be sure that each line has the same port name all the times
   you should specify a port name for each invocation.
   Obviously at least different serial units or even different devices
   will need to be specified too.

                                 - Page 11 -
22.    Multiple Lines

   Those few changes to the config file can be given as command line
   parameters but it may be useful to copy the config file, make the changes
   to the new config file and specify this one as a command line parameter.

   Note that if a config file is specified as a cli argument only that one
   will be read and the default "mail:gotcha.config" will not be read.

23.    OwnDevUnit Library


   OwnDevUnit.library is a freeware library that manages access to devices
   for different programms.
   Say you have Gotcha running at serial.device unit 0 and want to make
   a call with Term. Without OwnDevUnit.library you will have to disable
   Gotcha and then make your call with Term. With OwnDevUnit.library
   Gotcha will be asked to release the device and Term can access it without
   the fear of Gotcha interfering. If Term is done it will tell
   OwnDevUnit.library so and Gotcha will get back access to the serial
   device.

   OwnDevUnit.library support is automatic. If the library can be opened,
   i.e it's in your libs: directory, it will be used.

24.    Configuration Commands


   All possible configuration and ARexx commands are listed in the
   keyword index section. The keywords are neither position nor case
   sensitive. Keywords that can be used both as a config parameter
   (i.e. in a config file or as a cli argument) and as ARexx command
   are marked "Config & Rexx", ARexx only commands "Rexx".

   If you wish to include spaces in a string parameter you must enclose
   the string in double-quotes. If you want to use double-quotes in a string
   you will need to escape the quote with a '\' (backslash). In this case
   backslashs need to be escaped too.

   If you use GConfig you don't have to worry about all this.

   Example: SYSOP "John Doe"
            SYSOP "John \"the quoted\" Doe"
            SYSOP "John \"the quoted\" Doe with a backslash \"

25.    Embedded Percent Commands

 In the AFTERSESSION, BBSCOMMAND, DIALER, FAXCOMMAND, FREQUEST, RINGCOMMAND,
TURNAROUND and VOICECOMMAND command-strings the following case-sensitive
embedded %-commands can be used.

    %s  ...  Serial device name
    %u  ...  Serial device unit
    %f  ...  Serial device flags
    %b  ...  Baudrate (computer to modem)
    %B  ...  Baudrate (modem to modem)
    %C  ...  Full CONNECT string from modem
    %Z  ...  Zone number of the remote system
    %N  ...  Net number of the remote system
    %F  ...  Fido node number of the remote system
    %P  ...  Point number of the remote system
    %D  ...  Domain of the remote system
    %n  ...  Complete FidoNet address of the other system
    %a  ...  Aka of the remote system (one aka per %a)
    %A  ...  All akas of the remote system (separated with space)
    %S  ...  Name of Sysop of other system
    %R  ...  Name of Gotchas ARexx port
    %p  ...  Name of the public screen
    %l  ...  Name of the logfile

                                 - Page 12 -
25.    Embedded Percent Commands

    %I  ...  Inbound path
    %O  ...  Outbound path
    %d  ...  1 if inbound call, -1 if outbound call
    %?#?...  see explanation below
    %r  ...  Unique random number (a timestamp)
    %%  ...  %

In order to make it possible to execute different commands or pass different
arguments to commands on incoming than on outgoing calls the %? command was
implemented.  E.g TURNAROUND "echo \"Turnaround for this %?incoming#outgoing?
call\"" would echo "Turnaround for this incoming call" for incoming calls and
"Turnaround for this outgoing call" for outgoing calls.

For the FREQUEST command, the following commands are allowed in addition to
the above:

    %i  ...  name of the received .REQ file
    %o  ...  name of the .RLO file the result should be stored in

26.    Modem Strings

All commands sent ot the modem such as DIALSUFFIX, MODEMINIT, MODEMHANG,
MODEMANSWER accept some special characters in their strings.

    ~   ... Short delay (aprox. 1/3 of a sec)
    ^   ... Hang up, (i.e. drop DTR - wait - raise DTR)
    |   ... Send a carriage return character
    \   ... Escape character, send next character unchanged

All other characters will be sent to the modem without any changes. If you
need to send a "~","^" or "|" character to the modem you will need to escape
it with a backslash ('\').
    E.g it you want to send ~AT~ to your modem you have to use \~AT\~.

Take care if you need to have spaces in these strings you will have to escape
the backslash (since the string must be put in double-quotes then).
    E.g. " AT ~" -> " AT \~"

And even worse if you need to send a backslash to the modem:
    ' AT \' -> " AT \" -> " AT \\"
 This will result in " AT \" when the config is read and when sent to the
modem '\' will become a singe backslash again.

27.    Commodity Info

 Gotcha is a commodity. The popup key can be specified with CX_POPKEY command
and the priority with CX_PRIORITY.

If the hotkey is pressed Gotcha will open its window nearly all the time
immediately. Delays may happen if Gotcha is just in handshake phase with
another system, just have some patience then.

If you klick the close gadget Gotcha will hide rather than exit. If Gotcha has
opened its own screen that one will be closed too if no other windows are
opened on it.


 If you have opened Workbench you can iconify Gotcha, it will use its info
file "mail:def_gotcha.info" or, if that's not available, use the default tools
icon.

28.    Filenames


    2-dimensional Filenames

2D filenames have the form 'aaaabbbb.ext'.

                                 - Page 13 -
28.    Filenames

    'aaaa' is the net number in hexadecimal notation.
    'bbbb' is the node number in hexadecimal notation.
    'ext'  the file extension (e.g. 'PKT')

This format is rather old and usually files are stored with 4D filenames
nowadays and are converted to 2D when transfered.


    4-dimensional Filenames

4D filenames have the form 'zone.node.net.point.ext'. The advantage over
2D-filenames is that zone and point information is included in the file name,
most mailers/tossers support this naming scheme.



Gotcha will scan the outbound directory for both filenames.

29.    Flow Files


   Flow Files

   These files hold the path and name of files that should be sent to the
other system. Each line refers to one file. The filenames listed may be
preceded by a special character, indicating that some special processing needs
to be done after sending the file.

Possible special characters are:
   ~ ... Don't send this file (has already been sent)
   @ ... Allow filenote tagging
   - ... Delete this file without logging
   ^ ... Delete this file with logging
   # ... Truncate this file to zero length

Files with the following extensions are flow files: .FLO, .HLO, .CLO, .DLO

30.    Compressed Mail


   Compressed Mail files

   These files are not sent automatically, i.e. Gotcha won't look for these
   files when scanning the outbound directory while in a session.
   To be sent out they must be listed in a flow file (#?.?LO, e.g.
   35.23.7.34.FLO).

   The filenames have the form <address>.<weekday><number>, where address is
   either a 4D filename (e.g. 22.7.44.0.MO0) or consists of 8 hex digits,
   the first 4 representing the difference between the net number of the
   orginating and destination system, and the second 4 digits the difference
   between the node numbers. 'weekday' is two characters, the first two
   characters of a weekday (i.e. MO, TU, WE, TH, FR, SA, SU) and number is a
   hex digit to prevent duplicate filenames.

   The creation of both compressed mail files, and the belonging flow files
   is usualy the duty of a tosser (Spot, Traptoss, MailManager just to name
   a few).

   Examples: 34.5.23.0.MO9, 001F0034.SU0

31.    Outbound File Tagging


   Outbound File Tagging

   Some outgoing files need to be renamed, e.g. 4D filenames will be

                                 - Page 14 -
31.    Outbound File Tagging

   converted to 2D filenames and the extension of mail packets (.OUT, .DUT,
   .HUT, .CUT) will be changed to .PKT.
   Sometimes (e.g. for points) a random 2D filename will be created (from
   the current time), now if a transfer failes those files would get a
   different name, thus making a resume impossible, to avoid this the newly
   created name will be recorded in the file's filenote with a 'Name' tag,
   so in case of a interupted transfer the file will be sent under the same
   name again.

   With this you can make Gotcha send files with any name you want e.g.
   with 'filenote mail:outbound/foo.doc "Name bar.txt;"' you can make
   Gotcha send 'foo.doc' as 'bar.txt' (of course 'foo.doc' needs to be
   listed in a flow file to be sent at all).

32.    Inbound File Tagging


   Inbound File Tagging

   When Gotcha receives a file it will first give it a 'transfer name'.
   I.e. ¿.87ED8ADFF.PKT.2.139.34.0. If the transfer was successfull the file
   will be renamed to it's original name (in this case 87ED8ADFF.PKT).

   Gotcha will also set some filenote tags:
      FileName ... the original filename (useful if the filename was bumped)
      From     ... the address of the node we got the file from
      Length   ... the length of the file

33.    Filename Bumping


   Filename Bumping

   If a file has been received successfully Gotcha will rename the file
   to its original name (Gotcha received it under a special filename) it may
   however happen that a file with the same name already exists.
   If the filename consists of 8 digits plus a dot plus a 3 character
   extension Gotcha will change the digit part until the filename is
   unique.
   If the filename is not a 8 digit + dot + 3 char extension name Gotcha
   will add a "," and a number and keep incrementing the number until the
   filename is unique.

34.    Acknowledgements


  Thanks got to
      all registered users

      everybody who sent bug reports and/or suggestions

      Olaf `Olsen' Barthel for releasing the Term and HydraCom Amiga sources.

  The following names are either trademarks or the efforts of the person
  and/or company listed:

      gtlayout.library by Olaf `Olsen' Barthel
      xprzedzap.library by Yves Konigshofer.
      YooHoo by Wynn Wagner III.
      ZModem by Chuck Forsberg.
      The Licence Agreement was inspired by the FrontDoor Licence Agreement.
      Fido and FidoNet are trademarks of Tom Jennings, Fido Software.
      FrontDoor by Joaquim Homrighausen.
      ARexx by William S. Hawes, Wishful Thinking Development Corp.
      EMSI by the EMSC.
      Excelsior! BBS by Sycom Design.
      OwnDevUnit.library by Christopher A. Wichura

                                 - Page 15 -
34.    Acknowledgements

      TrapDoor is a registered trademark of Maximilian Hantsch
      and Martin Laubach.

35.    Requirements



   Gotcha requires OS 2.04 or better. That's it!

   (Oh well, alright, you got me; I admit: some kb of memory and diskspace
    will be needed too ;)

36.    Legal Stuff


  All Thomas Bickel products are trademarks of Thomas Bickel.
  Other brand and product names are trademarks or registered trademarks of
  their respective holders.

  Copyright 1995/1996 Thomas Bickel; All rights reserved.


  LICENCE AGREEMENT

    This is a licence agreement between you, the user, and Thomas Bickel,
  hereafter "the author". The Gotcha Shareware software and information
  attached hereto, hereafter "Gotcha", is the property of the author.
  Read the terms and conditions of this licence agreement carefully before
  using the software. If you for any reason, whatsoever, cannot accept the
  conditions in this agreement, you are not permitted to use Gotcha.

    You acknowledge and agree that Gotcha is a proprietary product of the
  author, protected by applicable copyright laws and international
  treaty provisions. You further acknowledge and agree that all rights,
  title, and interest in and to Gotcha are and shall remain with the
  author.

    Gotcha may be used for a period of thirty (30) days on a trial basis to
  allow you to determine its suitability for your particular
  application. After this period you MUST register Gotcha.

    Registration entitles you to a non-transferable licence to use Gotcha
  and any future versions of Gotcha for as long as you wish, subject to any
  special licensing conditions and/or applicable upgrade fees attached
  to future versions.

    In the event that you are in violation of this licence agreement, you
  agree and accept that the author may cancel your registration and any
  rights to use Gotcha that you may have. In the case of a dispute over the
  licence agreement, you further agree and accept to fully reimburse
  the author for legal and other expenses resulting from the dispute,
  should the dispute be decided in favor of the author.

    The author is in no way obligated to provide future versions of, or
  support for, Gotcha.

    You may freely distribute and copy Gotcha provided that no fee is charged
  and the Gotcha distribution archive contains unmodified copies of the
  original files as produced by the author. No part of Gotcha may be
  modified, altered, reverse engineered, sold, or distributed in any form
  whatsoever which would involve some sort of trade without prior written
  permission from the author. Gotcha may be put on Aminet CDs.

    In the case of any of the provisions of this agreement not being legally
  effective or losing its legal validity due to some subsequent circumstance,
  or in the case of a gap in this agreement coming into light, the legal
  validity of the remaining provisions will not be affected. An appropriate

                                 - Page 16 -
36.    Legal Stuff

  regulation is to take place of the ineffective provisions or fill the gap,
  which as far as legally possible, comes nearest to fulfilling the
  intentions the author had he considered the matter in question. If the
  invalidity of a provision is due to a scale of the performance contained
  therein, then a legally permissible scale is to be inserted with due regard
  to the aforesaid.

  DISCLAIMER

    Gotcha is provided "as is", without warranty of any kind or fitness for a
  particular purpose, either expressed or implied, all of which are hereby
  explicitly disclaimed. The author only guarantees that Gotcha will occupy
  disk space.
  In no event shall the author be liable to you or anyone else for any
  damages, including any lost profits, lost savings or other incidental or
  consequential damages arising out of the use or inability to use this
  software.


=============================================================================

                       The HYDRA protocol was designed by
                 Arjen G. Lentz, LENTZ SOFTWARE-DEVELOPMENT and
                             Joaquim H. Homrighausen
                  COPYRIGHT (C) 1991-1993; ALL RIGHTS RESERVED

  Hydra protocol design and HydraCom driver:         Hydra protocol design:
  Arjen G. Lentz                                     Joaquim H. Homrighausen
  LENTZ SOFTWARE-DEVELOPMENT                         389, route d'Arlon
  Langegracht 7B                                     L-8011 Strassen
  3811 BT  Amersfoort                                Luxembourg
  The Netherlands
  FidoNet 2:283/512, AINEX-BBS [phone]         FidoNet 2:270/17
  [e-mail]               [e-mail]


=============================================================================

 The xprzedzap.library is public domain and is not copyrighted. You may do
 with it as you please. It was written by Yves Konigshofer. See the
 xprzedzap.library documentation for more information.

=============================================================================

 gtlayout.library:
 Copyright (c) 1993-1995 by Olaf `Olsen' Barthel
 Freely distributable.

=============================================================================

37.    Contact


   The author of this software can be reached via e-mail:

   2:310/72.34@FidoNet

   Internet: [e-mail]


   Or via snail mail:

   Thomas Bickel
   Effingerg. 10/12
   A-1160 Wien
   Austria / Europe


                                 - Page 17 -
37.    Keywords


38.    Keywords


   ADDMONITOR
   ADDRESS
   AFTERSESSION
   AKAS
   ALLOWREFUSING
   ANSWER
   AUTOSELECT
   BACKGROUND
   BANNER
   BBS
   BBSCHAR
   BBSCOMMAND
   BBSMESSAGE
   BBSMODE
   BOSSNUMBER
   BUFFEREDLOG
   CALL
   CALLERID
   CLOSEWINDOW
   CONSCREEN
   CONWIN
   COST
   CX_POPKEY
   CX_PRIORITY
   DIALER
   DIALPREFIX
   DIALSUFFIX
   DIALTIMEOUT
   DIRECTZAP
   DISPLAYID
   EMSI
   ESCAPERESETSMODEM
   FAXCOMMAND
   FAXSTRING
   FKEYs
   FORBIDALL
   FORBIDFREQ
   FORBIDXMAIL
   FREQUEST
   GETCONFIG
   HYDRA
   ICONIFY
   IMMEDIATE
   INBOUND
   INDIR
   KEEPALL
   KEEPXMAIL
   KIWIPULSE
   LISTEN
   LOADINGMESSAGE
   LOCATION
   LOG
   LOGFILE
   LOGLEVEL
   LOGLINES
   MINBAUD
   MODEMANSWER
   MODEMDIALPOST
   MODEMDIALPRE
   MODEMHANG
   MODEMHANGUP
   MODEMINIT
   MODEMRESETINTERVAL

                                 - Page 18 -
38.    Keywords

   MRC_BUSY
   MRC_CARRIER
   MRC_CONNECT
   MRC_FAX
   MRC_NOANSWER
   MRC_NOCARRIER
   MRC_NODIALTONE
   MRC_RING
   MRC_RINGING
   MRC_VOICE
   NAME
   NLDIR
   NOALLOWREFUSING
   NODELIST
   NODE
   NODIRECTZAP
   NOEMSI
   NOESCAPERESETSMODEM
   NOFORBIDALL
   NOFORBIDFREQ
   NOFORBIDXMAIL
   NOHYDRA
   NOKEEPALL
   NOKEEPXMAIL
   NOKIWIPULSE
   NOLISTEN
   NONEMESSAGE
   NORETRYHANDSHAKE
   NOSTRIPDASHES
   NOSWEPULSE
   NOUNLISTEN
   NOWAZOO
   NOXMAIL
   NOZEDZAP
   NOZEDZIP
   ONCLOSEWINDOW
   OPENWINDOW
   OUTBOUND
   OUTDIR
   PASSWORD
   PHONENUMBER
   PICKUP
   QUIET
   QUIT
   REDIALDELAY
   REMMONITOR
   RESET
   RETRIES
   REXXNAME
   RINGCOMMAND
   RINGINGS
   RINGS
   RUN
   SCLEAR
   SCREENMODE
   SCREENTOBACK
   SCREENTOFRONT
   SERIALBAUD
   SERIALDEVICE
   SERIALFLAGS
   SERIALUNIT
   SFKEYs
   SHOWREXX
   SLINE
   SMODEM
   SPAWNMESSAGE
   SPAWN

                                 - Page 19 -
38.    Keywords

   STARTSESSION
   STIMEOUT
   STRIPDASHES
   SWAIT
   SWEPULSE
   SWRITE
   SYSOP
   TASKPRI
   TIMESTAMP
   TURNAROUND
   UNICONIFY
   UNLISTEN
   USESYSFONT
   VERSION
   VOICECOMMAND
   VOICESTRING
   WAZOO
   XMAIL
   ZEDZAP
   ZEDZIP
   ZMHMESSAGE

39.    ADDMONITOR


   ADDMONITOR ARexx-port                                       Config & Rexx

      This adds a ARexx-port to the list of ports Gotcha sends status
   messages to.
   Lists in this list will receive messages in the form:
   "<STATUS><GOTCHA-REXXPORT>[<optional information>]"

   Following states are defined yet (<STATE><optional information>):

   GRX_CALLING <number>    ... Gotcha is about to call <number>

   GRX_CONNECT <connect string>  ... There was a connect

   GRX_HANDSHAKE     ... Gotcha is about to enter handshake phase

   GRX_XFER          ... Files will be transfered now

   GRX_CALL_OK       ... The call was successful

   GRX_CALL_FAILED   ... The cal was not successful

   GRX_IDLE          ... Sent every MODEMRESETINTERVAL minutes

   GRX_REDIALDELAY   ... There are numbers left to dial entering delay

   GRX_REDIALABORT   ... Further retries have been aborted

   GRX_REDIALEND     ... Nothing left to dial

   GRX_QUIT          ... Gotcha has been terminated

   GRX_CALL_INFO <online secs> <cost>  ... Given after a call if secs<>0

   GRX_INCOMING      ... Incoming call detected

   GRX_UNLISTEN      ... UNLISTEN received

   GRX_LISTEN        ... LISTEN received

   GRX_ODUNLISTEN    ... OwnDevUnit requested the serial device

   GRX_ODLISTEN      ... Got the serial device back from OwnDevUnit

                                 - Page 20 -
39.    ADDMONITOR


   GRX_CALL_LIST <numbers>    ... All numbers in the call/dial list

   GRX_END_OF_CALL   ... At the end of a call

   GRX_HUMAN_CALLER  ... A human caller was detected

   GRX_FAX           ... A fax call was detected

   GRX_VOICE         ... A voice connect was made

   GRX_RI_NAME <name>   ... Remote info name

   GRX_RI_ADDRESS <address>   ... Remote info address

   GRX_RI_AKA <akas>    ... Remote info akas

   GRX_RI_SYSOP <sysop> ... Remote info sysop

   GRX_RI_PLACE <place> ... Remote info location

   GRX_RI_PHONENUMBER <phonenumber>    ... Remote info phonenumber

   GRX_RI_MAILER <mailer>  ... Remote info mailer

   GRX_RI_OFFER <offer>    ... Remote info offer

   GRX_RI_FLAGS <flags>    ... Remote info flags

   GRX_RI_END        ... End of remote info messages

   In a config file (cli arg) only one port can be specified, via the
   ARexx command a unlimited number can be added. Upon reception of
   ADDMONITOR the given port must already exist or it will not be added.
   Ports a message could not be sent to will be removed from the port
   list.

   Example: ADDMONITOR "GOTCHA_MONITOR"

40.    ADDRESS


   ADDRESS zone:net/node[.point][@domain]                      Config & Rexx

   This sets your main address.
   If you have more then one address see AKAS.


   Examples: ADDRESS 2:310/108@fidonet
             ADDRESS 39:23/5.3@AmigaNet
             ADDRESS 2:310/108.3

41.    AFTERSESSION


   AFTERSESSION command-string                                 Config & Rexx

   The command executed after every session.

      After every session with another node the command specified with
   this keyword will be executed. There may be embedded %-commands in
   the string. The values such as %n (address of the remote system) will
   be substituted by the parameters of the session that just ended.
   To have no aftersession-command use AFTERSESSION "" or omit the
   statement completely.

   Examples: AFTERSESSION "execute s:aftersession.bat"

                                 - Page 21 -
41.    AFTERSESSION

             AFTERSESSION ""

42.    AKAS


   AKAS akalist                                                Config & Rexx

      During an EMSI-handshake not only your main address will be sent
   to the other system but (if available) also a list of "also-known-as"
   addresses. Using the AKAS keyword you can specify all of your AKA
   adresses.
   The length of this string is limited to 1000 characters.

   Example: AKAS "39:23/5.3@amiganet 27:47/11"
            AKAS ""

43.    ALLOWREFUSING


   ALLOWREFUSING                                                        Rexx

   This is a synonym for NOALLOWREFUSING NO.

44.    ANSWER


   ANSWER on/off                                                      Config

      If answer is on Gotcha will hang around receiving and making outgoing
   calls. This realy should be turned on if you are a node...
   For points this should be turned off. If turned off Gotcha will
   call the number(s) specified with BOSSNUMBER and then exit.

   Examples: ANSWER ON
             ANSWER OFF

45.    AUTOSELECT


   AUTOSELECT on/off                                           Config & Rexx

      When AUTOSELECT is turned on and you have AKAS Gotcha will select
   the address that matches the remotes one best as your main address.
   Say you are ADDRESS 2:310/108.3 AKA 39:23/5.3, so if AUTOSELECT is
   turned on and you are calling 39:23/5, 39:23/5.3 will become main
   address and 2:310/108 will be your AKA.

   Examples: AUTOSELECT ON
             AUTOSELECT OFF

46.    BACKGROUND


   BACKGROUND on/off                                           Config & Rexx

      When BACKGROUND is turned on Gotcha will open it's screen behind
   all other screens.

   Examples: BACKGROUND ON
             BACKGROUND OFF

47.    BANNER


   BANNER bannerline                                           Config & Rexx

      This line (or file) will be sent to the other system when Gotcha

                                 - Page 22 -
47.    BANNER

   answers a call. To specify a file use "<" as the first character.

   Examples: BANNER "Welcome to TNT Amiga only BBS Line 2"
             BANNER "<mail:welcome.txt"

48.    BBS


   BBS bbsname                                                 Config & Rexx

      Name of this node which will be sent to the remote system while
   handshake.

49.    BBSCHAR


   BBSCHAR character                                           Config & Rexx

      This option is included to allow for other "drop-to-the-bbs"
   characters in addition to the ESC-key.

   Examples: BBSCHAR !
             BBSCHAR '!'
             BBSCHAR $21

50.    BBSCOMMAND


   BBSCOMMAND command-string                                   Config & Rexx

      This command which may include embedded %-commands will be executed
   whenever a human caller is calling your BBS.

   This command will only be executed if the BBSMODE is SPAWN or EXIT.

   Example: BBSCOMMAND = "bbs:excelbbs/bb -B %B -U 1 -L 1 -G -7 -S"

51.    BBSMESSAGE


   BBSMESSAGE text                                             Config & Rexx

      With this keyword you can override the ZHMMESSAGE, NONEMESSAGE,
   SPAWNMESSAGE settings. If not empty instead of the texts specified
   with the other keywords this text will be sent right after the banner.

   Examples: BBSMESSAGE "Sorry, this BBS is offline until 5:30"
             BBSMESSAGE ""

52.    BBSMODE


   BBSMODE mode                                                Config & Rexx

   There are four different modes to use Gotcha with(out) a BBS:

   NONE  ... There is no BBS. NONEMESSAGE will be displayed to human
             callers

   SPAWN ... If a human caller enters two ESC characters the BBS will
             be launched. When the command returns the modem will
             be reseted and Gotcha will continue waiting for calls.
             SPAWNMESSAGE is displayed.

   EXIT  ... Same as SPAWN, but as soon as the command returns Gotcha
             will exit.


                                 - Page 23 -
52.    BBSMODE

   ZMH   ... "Zone Mail Hour" There is a BBS, but at the moment no
             human callers are allowed.
             Gotcha will display ZMHMESSAGE.

   Examples: BBSMODE SPAWN
             BBSMODE ZMH

53.    BOSSNUMBER


   BOSSNUMBER number/address                                   Config & Rexx

      With this keyword points can specify their bosses phonenumber(s)
   or address(es). If Gotcha is not in answer mode it will simply call
   the number(s) specified with this keyword and then exit.
   If you use a nodelist you can also specify addresses here.
   Note that this can also be used in answer mode. To make Gotcha call
   the numbers given with this keyword send "CALL BOSS" to Gotchas
   ARexx port.

   Examples: BOSSNUMBER "2:310/108"
             BOSSNUMBER "39:23/5!2:310/108"

54.    BUFFEREDLOG


   BUFFEREDLOG yes/no                                          Config & Rexx

      If NO is selected every line written to the window will be written
   the the logfile immediately. If YES is selected the lines will first
   be written to a buffer and every ~512 bytes written to the logfile.

   The advantage of turning buffering on is that it is much faster, however
   if there are crashes the important part may not be written to the log.

   Examples: BUFFEREDLOG YES
             BUFFEREDLOG NO

55.    CALL


   CALL number(s)                                                       Rexx

      If Gotcha is in answer mode you can place outgoing calls by sending
   ARexx CALL commands to it's rexx-port. Unlike other mailers Gotcha can
   handle more than one number/address at one time.
   If Gotcha is already making outgoing calls it will attempt to append
   the new numbers to the list of old ones. This may fail if you specify
   to many numbers.
   There is a limit of 1000 characters for this string.

   If you are using addresses you must specify the zone since Gotcha uses
   the ':' character to distinguish addresses from phonenumbers.

   Please note that REDIALDELAY and RETRIES will also be used.
   First Gotcha will try to call all nodes in the list. For successfull
   sessions the main address and all akas will be removed from the list.
   If lines were BUSY or sessions were not successfull Gotcha will wait
   REDIALDELAY seconds until it makes another attempt.
   This will happen RETRIES times.

   Note that in answer mode Gotcha is able to receive incomming calls
   while it's waiting for another retry.

   Examples:
      "CALL 2:310/108!39:23/5" will call 2:310/108 and 39:23/5 and
      keep calling until either each call was successfull or no retries

                                 - Page 24 -
55.    CALL

      are left.

      "CALL BOSS" will call the numbers specified with the BOSSNUMBER
      keyword.

56.    CALLERID


   CALLERID <filename>                                         Config & Rexx

   If specified the callerid (received between first and second RING) will
   be saved to <filename>.

   Example: CALLERID "mail:cid"

57.    CLOSEWINDOW


   CLOSEWINDOW                                                          Rexx

   This Rexx-command will close the outputwindow.

58.    CONSCREEN


   CONSCREEN screenname                                        Config & Rexx

   Specifies the screen Gotcha should open on. If no such (public) screen
   exists Gotcha will open an own screen, depending on the SCREENMODE.

   Example: CONSCREEN "SPOT"

59.    CONWIN


   CONWIN Left/Top/Width/Height                                Config & Rexx

   This specifies the position and size of the window.

   Example: CONWIN 10/10/500/200

60.    COST


   COST value                                                  Config & Rexx

      This vaulue which should be given as units/minute, will be used if
   no nodelist is used to determine the cost of a call.

   Example: COST 100

61.    CX_POPKEY


   CX_POPKEY string                                                   Config

      This specifies the commodity "Hotkey". If pressed and the window is
   closed the window will open.

   Example: CX_POPKEY "rwakey control esc"

62.    CX_PRIORITY


   CX_PRIORITY pri                                                    Config

      This is the commodity priority.

                                 - Page 25 -
62.    CX_PRIORITY


   Example: CX_PRIORITY 0

63.    DIALER


   DIALER dialer-command                                       Config & Rexx

      Use this if you have a custom dialer that performs some special
   magic for you. Embedded %-commands can be used in the command.

   If specified instead of dialing out the command will be executed and
   if it returns the session handshake will be attempted.

   Examples: DIALER "callpcp"
             DIALER ""

64.    DIALPREFIX


   DIALPREFIX string                                           Config & Rexx

      Modem dial string such as "ATDT" or "AT~~DT~". This string will be
   sent to the modem whenever Gotcha wants to call out.
   The string can have special modem characters in it if needed.

   Examples: DIALPREFIX "ATDT"
             DIALPREFIX "AT~~D"

65.    DIALSUFFIX


   DIALSUFFIX string                                           Config & Rexx

      This string will be sent to the modem after the DIALPREFIX string
   and the number have been sent. This usualy is just a "|".
   The string can have special modem characters in it if needed.

   Example: DIALSUFFIX "|"

66.    DIALTIMEOUT


   DIALTIMEOUT seconds                                         Config & Rexx

      Specifies how long Gotcha will wait for a response (e.g. BUSY,
   NO DIAL TONE, VOICE, NO CARRIER, CONNECT) from the modem
   after it has sent the dialstring.

   Example: DIALTIMEOUT 70

67.    DIRECTZAP


   DIRECTZAP                                                            Rexx

   This is the same as NODIRECTZAP = NO.

68.    DISPLAYID


   DISPLAYID integer                                           Config & Rexx

      Specifies the mode in which Gotcha should open it's screen.
   This ofcourse will only have an effect if Gotcha opens it's own screen
   at all (see SCREENMODE).


                                 - Page 26 -
68.    DISPLAYID

   Examples: DISPLAYID $19000   ;NTSC Hires
             DISPLAYID $29000   ;PAL Hires
             DISPLAYID $19020   ;NTSC Superhires
             DISPLAYID $29020   ;PAL Superhires
             DISPLAYID $19004   ;NTSC Hires Interlace
             DISPLAYID $29004   ;PAL Hires Interlace
             DISPLAYID $19024   ;NTSC Superhires Interlace
             DISPLAYID $29024   ;PAL Superhires Interlace
             DISPLAYID $39024   ;VGA Productivity
             DISPLAYID $39025   ;VGA Productivity Lace
             DISPLAYID $39020   ;VGA Productivity Dbl (AA)

69.    EMSI


   EMSI                                                                 Rexx

   This is the same as NOEMSI = NO.

70.    ESCAPERESETSMODEM


   ESCAPERESETSMODEM yes/no                                    Config & Rexx

      If you press the ESC key during a session Gotcha will stop the
   session immediately. If this option is YES the modem-init string
   will be sent too. If it is no then you will have to press ESC a second
   time to reset it or wait until MODEMRESETINTERVAL does it for you.

   Example: ESCAPERESETSMODEM NO

71.    FAXCOMMAND


   FAXCOMMAND command                                          Config & Rexx

      This command, which may contain embedded %-commands, will be
   executed whenever, on a outgoing or incomming call, the string
   specified in MRC_FAX is received.

   Examples: FAXCOMMAND "fax %?letter1#letter2?"
             FAXCOMMAND ""

72.    FAXSTRING


   FAXSTRING string                                                     Rexx

   This is the same as MRC_FAX.

   Example: FAXSTRING "FAX"

73.    FKEYs


   FKEY<x> rexx-command                                        Config & Rexx
   SFKEY<x> rexx-command

      Assigns a rexx-command to a functionkey. Whenever a functionkey
   is pressed Gotcha will send the associated command to it's own
   Rexx-port.

   Examples: FKEY1 "NOEMSI NO"            ; F1
             FKEY2 "NOEMSI YES"           ; F2
             FKEY3 "CALL 123456"          ; F3
             SFKEY1 "NOWAZOO NO"          ; Shift-F1
             SFKEY9 "NODIRECTZAP YES"     ; Shift-F9

                                 - Page 27 -
73.    FKEYs


74.    FORBID


   FORBIDALL yes/no                                            Config & Rexx
   FORBIDFREQ yes/no
   FORBIDXMAIL yes/no

      This selects what kind of mail you do not want to receive.
   In an EMSI handshake Gotcha will ask (!) the other system not to
   send theses files. The other end may however simply ignore this
   (e.g. by setting NOALLOWREFUSING = YES).

   FORBIDALL   Compressed mail and file attaches
   FORBIDFREQ  File Requests
   FORBIDALL   Anything (hold all traffic)

   Example: FORBIDALL YES

75.    FREQUEST


   FREQUEST command-string                                     Config & Rexx

      Sets the command to launch the filerequest-server. Like all
   external commands this one may have embedded %-commands in the
   string.
   Note that asynronous execution is not allowed for this one, since
   right after the command returns the outbound dir will be rescaned
   for files to send to the remote system.

   Example: "rx frequest.rexx %i %o %S"

76.    GETCONFIG


   GETCONFIG keyword                                                    Rexx

      With this ARexx-only command it is possible to get the current
   configuration for a certain keyword. So you can first get the current
   config, change it do some action and then set it back to the old
   value.

   ----------------------- cut here ----------------------

   'GETCONFIG LOCATION'        /* get the current location */
   config = RESULT

   'LOCATION "My Place"'       /* set location to "My Place" */

   'CALL 12345'                /* call out */

   config                      /* set back the old config */

   ----------------------- cut here ----------------------

   Examples: GETCONFIG AKAS
             GETCONFIG MRC_FAX

77.    HYDRA


   HYDRA                                                                Rexx

   This is the same as NOHYDRA = NO.



                                 - Page 28 -
77.    ICONIFY


78.    ICONIFY


   ICONIFY                                                              Rexx

      This ARexx only command will iconify Gotcha if its window is open.
   I.e. if Workbench is loaded the window will be closed and an
   application icon will be put on the Workbench screen.
   If you want to use your own icon place a file called "def_Gotcha.info"
   in your mail: drawer.

79.    IMMEDIATE


   IMMEDIATE yes/no                                            Config & Rexx

      If IMMEDIATE = YES is specified Gotcha will go directly and
   immediately to the session handshake.
   If in answer mode Gotcha will act as if it had detected an incomming
   call.

   Defaults to NO.

   Example: IMMEDIATE YES

80.    INBOUND


   INBOUND                                                              Rexx

   This is the same as INDIR.

81.    INDIR


   INDIR directory                                             Config & Rexx

      This should be set to your inbound directory. Incomming mail and
   files will be stored here. Also temporary files will be created here
   during file transferes.

   Example: INDIR "mail:inbound"

82.    KEEP


   KEEPALL yes/no                                              Config & Rexx
   KEEPXMAIL yes/no

      This if set to YES this keywords disallow the sending of certain
   files during sessions.

   KEEPALL surpresses the sending of any files.
   KEEPXMAIL will surpress the sending of compressed mail files.

   Example: KEEPALL YES

83.    KIWIPULSE


   KIWIPULSE yes/no                                            Config & Rexx

      Applies a special number translation for Kiwi people.

   Example: KIWIPULSE YES


                                 - Page 29 -
83.    LISTEN


84.    LISTEN


   LISTEN                                                               Rexx

      LISTEN is a synonym for NOUNLISTEN and NOLISTEN is a synonym
   for UNLISTEN.

85.    LOADINGMESSAGE


   LOADINGMESSAGE string                                       Config & Rexx

      This text will be displayed to human usern when the BBS is loaded.

   Example: LOADINGMESSAGE "Please wait spawning the BBS..."

86.    LOCATION


   LOCATION string                                             Config & Rexx

      Sets the location of your node.

   Example: LOCATION "Vienna; Austria"

87.    LOG


   LOG <level><text>                                                    Rexx

      This Rexx command will put out a text with the given loglevel to
   the logwindow and logfile.

   Example: LOG "1 This is a test"

88.    LOGFILE


   LOGFILE filename                                            Config & Rexx

      Sets the name of the logfile. Everything you see in Gotchas main
   window will also be saved to the logfile. The amount of information
   displayed/saved depends on the LOGLEVEL setting.

   Example: LOGFILE "mail:Gotcha.log"

89.    LOGLEVEL


   LOGLEVEL level                                              Config & Rexx

      Sets the amount of logging information written to the logfile.
   There are 6 levels:

   1 SILENCE   ... nearly no output
   2 MINIMUM   ... some more infos
   3 NORMAL    ... this is quite nice
   4 VERBOSSE  ... nearly everything (IMHO the best)
   5 MAXIMUM   ... all there is
   6 DEBUG     ... even more (but nothing realy needed)

   Example: LOGLEVEL 5




                                 - Page 30 -
89.    LOGLINES


90.    LOGLINES


   LOGLINES <num lines>                                               Config

   Specifies how many lines will be buffered in the scrollback buffer of
   the main window. Minimum is 100, maximum 1000.

   Example: LOGLINES 200

91.    MINBAUD


   MINBAUD baudrate                                            Config & Rexx

      Minimum baudrate to establish a connection at. If the connection
   baudrate is lower than specified with this keyword Gotcha will hang
   up immediately (on both incomming and outgoing calls).

   Example: MINBAUD 2400

92.    MODEMANSWER


   MODEMANSWER string                                          Config & Rexx

      This string will be sent to the modem when the number of RINGs
   specified with the RINGS keyword have been received and Gotcha wants
   to answer the phone. The string can have all the special modem characters
   in it.

   Example: MODEMANSWER "ATA|"

93.    MODEMDIALPOST


   MODEMDIALPOST string                                                 Rexx

   Same as DIALSUFFIX.

94.    MODEMDIALPRE


   MODEMDIALPRE string                                                  Rexx

   Same as DIALPREFIX.

95.    MODEMHANG


   MODEMHANG string                                            Config & Rexx

      This string will be sent to the modem whenever Gotcha wants to
   hang up. Using "~~~+++~~~ATH0|" is not recomended, you should
   configurate your modem in way that it hangs up as soon as DTR is
   lowered. The recomended string for this setting is "^".
   The string can have special modem characters in it.

   Example: MODEMHANG "^"

96.    MODEMHANGUP


   MODEMHANGUP string                                                   Rexx

   This is the same as MODEMHANG.

                                 - Page 31 -
96.    MODEMHANGUP


97.    MODEMINIT


   MODEMINIT string                                            Config & Rexx

      This string will be sent to the modem whenever Gotcha wants to init
   the modem. The string may contain all the special modem characters.
   Gotcha expects every char to be echoed by the modem and after every
   carriage-return "|" a "OK" from the modem (if there was something sent
   to the modem before).

   Example: MODEMINIT "AT~Z|"

98.    MODEMRESETINTERVAL


   MODEMRESETINTERVAL minutes                                  Config & Rexx

      In answer mode the MODEMINIT string will be sent to the modem
   every so many minutes.

   Example: MODEMRESETINTERVAL 15

99.    NAME


   NAME nodename                                                        Rexx

   This is the same as the BBS keyword.

100.    MODEMRESULTCODES


   MRC_BUSY string                                             Config & Rexx
   MRC_CARRIER string
   MRC_CONNECT string
   MRC_FAX string
   MRC_NOANSWER string
   MRC_NOCARRIER string
   MRC_NODIALTONE string
   MRC_RING string
   MRC_RINGING string
   MRC_VOICE string

      With these keywords you con configure Gotcha to what strings your
   modem sends on various occations.

   MRC_BUSY      ... Reported when the line is busy
   MRC_CARRIER   ... Not supported by all modems. The "modem to modem" speed
   MRC_CONNECT   ... The connection speed or (if possible) the computer to
                     modem speed.
   MRC_FAX       ... Reported for Fax connects
   MRC_NOANSWER  ... Sometimes reported instead of NO CARRIER
   MRC_NOCARRIER ... When carrier detect has failed
   MRC_NODIALTONE... If there is no dialtone
   MRC_RING      ... Rings on incomming calls
   MRC_RINGING   ... Rings on outgoing calls
   MRC_VOICE     ... For Voice connects

   If the CARRIER result code ist supported by your modem you should
   configurate the modem in a way that the baudrate reported with this
   keyword reflects the "modem to modem" rate and the rate reported with
   CONNECT the "computer to modem" speed. This is e.g. quite nice for
   Hydra transferes since Hydra will use both values to calculate maximum
   blocksizes and other things. However, if this is not possible it
   does not harm too much, acctualy on higher speeds (9600, 14400 for

                                 - Page 32 -
100.    MODEMRESULTCODES

   sure) the maximum blocksize will be at it's limit anyway.
   If CARRIER is not supported the "modem to modem" speed should be reported
   with the CONNECT-message (as is usualy the case) and the MRC_CARRIER
   keyword can be omited.

   Examples: MRC_BUSY "BUSY"
             MRC_CARRIER "CARRIER"
             MRC_CONNECT "CONNECT"
             MRC_FAX "FAX"
             MRC_NOANSWER "NO ANSWER"
             MRC_NOCARRIER "NO CARRIER"
             MRC_NODIALTONE "NO DIAL TONE"
             MRC_RING "RING"
             MRC_RINGING "RINGING"
             MRC_VOICE "VOICE"

   These settings are also the default.

101.    NLDIR


   NLDIR directory                                             Config & Rexx

      If you want to use a nodelist with Gotcha set this to the directory
   where the compiled nodlist is stored. On more information on how to
   use nodelists with Gotcha read the GList documentation.

   Example: NLDIR "mail:nodelist"

102.    NOALLOWREFUSING


   NOALLOWREFUSING yes/no                                      Config & Rexx

      This selects if the wishes of the other side in am EMSI handshake
   should be respected or not (see FORBID).

   Example: NOALLOWREFUSING NO

103.    NODELIST


   NODELIST directory                                                   Rexx

   This is the same as NLDIR.

104.    NODE


   NODE address                                                         Rexx

   This is the same as ADDRESS.

105.    NODIRECTZAP


   NODIRECTZAP yes/no                                          Config & Rexx

      This selects if the DirectZap transfer protocol should be used
   for transferes.

   Example: NODIRECTAZP YES

106.    NOEMSI


   NOEMSI yes/no                                               Config & Rexx

                                 - Page 33 -
106.    NOEMSI


      This selects if an EMSI handshake should be (at least) attempted.
   EMSI is the most up to date handshake available in FidoNet
   sessions. If turned off a lot of features can not be used. e.g it's
   only possible in EMSI handshakes to exchange AKAs.

   Example: NOEMSI NO

107.    NOESCAPERESETSMODEM


   NOESCAPERESETSMODEM                                                  Rexx

   This is the same as ESCAPERESETSMODEM NO.

108.    NOFORBID


   NOFORBIDALL                                                          Rexx
   NOFORBIDFREQ
   NOFORBIDXMAIL

   This is the same as FORBID<what> NO.

109.    NOHYDRA


   NOHYDRA yes/no                                              Config & Rexx

      This can be used to turn off Hydra transferes.

   Example: NOHYDRA YES

110.    NOKEEP


   NOKEEPALL                                                            Rexx
   NOKEEPXMAIL

   This is the same as KEEP<what> NO.

111.    NOKIWIPULSE


   NOKIWIPULSE                                                          Rexx

   This is the same as KIWIPULSE NO.

112.    NOLISTEN


   NOLISTEN                                                             Rexx

   This is the same as UNLISTEN.

113.    NONEMESSAGE


   NONEMESSAGE text                                            Config & Rexx

      This message will be displayed whenever an user calls and the BBSMODE
   is set to NONE. This can be overridden with the BBSMESSAGE keyword.

   Example: NONEMESSAGE "This is a mail only system -- please hang up"




                                 - Page 34 -
113.    NORETRYHANDSHAKE


114.    NORETRYHANDSHAKE


   NORETRYHANDSHAKE yes/no                                     Config & Rexx

      Specifies wether Gotcha will retry to call this number if the
   handshake failes for some reason. Usualy a number will only be removed
   from the dialing list if either the modem responded with something
   else than BUSY when dialing the number or the session was successful.
   It may however happen that the remote system has due to an error set
   up a wrong password for you. In this case you would be disconnected
   each time in the session handshake to prevent additional retries you
   can set this keyword to YES and whenever a handshake failes (for
   whatever reason) the number will be removed from the dialing list.

   Example: NORETRYHANDSHAKE YES

115.    NOSTRIPDASHES


   NOSTRIPDASHES                                                        Rexx

   This is the same as STRIPDASHES NO.

116.    NOSWEPULSE


   NOSWEPULSE                                                           Rexx

   This is the same as SWEPULSE NO.

117.    NOUNLISTEN


   NOUNLISTEN                                                           Rexx

   This is the same as LISTEN.

118.    NOWAZOO


   NOWAZOO yes/no                                              Config & Rexx

      Can be used to turn off WaZoo handshakes. Gotcha first tries to
   establish an EMSI handshake if this fails or Gotcha detects that the
   other side attempts an WaZoo handshake Gotcha will fall back to
   WaZoo. If you want you AKAs to be transfered always you should turn
   WaZoo off, so if an EMSI handshake fails no files at all will be
   sent but (if set) another attempt to do a EMSI handshake will be
   made at the next retry.

   Example: NOWAZOO YES.

119.    NOXMAIL


   NOXMAIL yes/no                                              Config & Rexx

      Enables/disables the setting of the XMA (compressed mail) flag
   for EMSI handshakes. This tells the other system if compressed
   mail should (not) be sent.

   Example: NOXMAIL NO




                                 - Page 35 -
119.    NOZEDZAP


120.    NOZEDZAP


   NOZEDZAP yes/no                                             Config & Rexx

      Used to turn on/off the usage of the ZedZap protocol for file
   transfers.

   Example: NOZEDZAP NO

121.    NOZEDZIP


   NOZEDZIP yes/no                                             Config & Rexx

      Used to turn on/off ZedZap protocol in transfers.

   Example: NOZEDZIP NO

122.    ONCLOSEWINDOW


   ONCLOSEWINDOW <HIDE|ICONIFY|QUIT>                           Config & Rexx

      With this keyword you can select what Gotcha will do if you press
   the window close gadget.

   HIDE     ... This is the default. Gotcha will hide.

   ICONIFY  ... Gotcha will iconify if Workbench is open.

   QUIT     ... Gotcha will quit.


   Example: ONCLOSEWINDOW = QUIT

123.    OPENWINDOW


   OPENWINDOW                                                           Rexx

      If this command is received and the window is closed it will be
   opened. Gotcha sends this to its own Rexx-Port whenever the commodities
   hotkey is pressed.

   Example: OPENWINDOW

124.    OUTBOUND


   OUTBOUND directory                                                   Rexx

   This is the same as OUTDIR.

125.    OUTDIR


   OUTDIR directory                                            Config & Rexx

      This sets the directory where Gotcha will look for outgoing files.

   Example: OUTDIR "mail:outbound"

126.    PASSWORD



                                 - Page 36 -
126.    PASSWORD

   PASSWORD string                                             Config & Rexx

      Specifies the password to be used in sessions.
   If nodelist support is enabled the password will be fetched from
   there.
   Note that if Gotcha is in answer mode and PASSWORD is set, it will be
   used whenever a node calls you have no password set up for via GList.
   If PASSWORD is not set Gotcha will not care about passwords for
   incomming calls unless you have set up a password via GList.

   Example: PASSWORD "secret"

127.    PHONENUMBER


   PHONENUMBER string                                          Config & Rexx

      Sets your own phonenumber. If you don't want it to be sent out
   in sessions set this to "-Unpublished-".

   Example: PHONENUMBER "43-456-7891234"

128.    PICKUP


   PICKUP < ALL | PRIMARY | NONE >                             Config & Rexx

      Select what mail and files to receive from the other system. This
   will only work with EMSI handshake sessions.

   ALL     ... everything there is
   PRIMARY ... only files for your primary address not for AKAs
   NONE    ... nothing at all

   Examples: PICKUP ALL
             PICKUP PRIMARY
             PICKUP NONE

129.    QUIET


   QUIET yes/no                                                       Config

      If set to YES Gotcha will not open a window or a screen but work
   in the background. The window can be opened with the OPENWINDOW
   Rexx command or by pressing the commodity hotkey.

   Example: QUIET NO

130.    QUIT


   QUIT                                                                 Rexx

      If Gotcha receives a QUIT Rexx command it will (guess what) quit
   if in answer mode. This is the same as pressing Alt-Q or Alt-X.
   If there is a session taking place it will quit as soon as it has ended.

131.    REDIALDELAY


   REDIALDELAY secs                                            Config & Rexx

      Specifies the number of seconds to wait until the next dialattempt
   is made. If in answer mode Gotcha will receive calls while waiting
   for the delaytime to expire.


                                 - Page 37 -
131.    REDIALDELAY

   Example: REDIALDELAY 60

132.    REMMONITOR


   REMMONITOR ARexx-port                                                Rexx

      This removes a port added with ADDMONITOR from the list.

   Example: REMMONITOR "GOTCHA_MONITOR"

133.    RESET


   RESET                                                                Rexx

   This will reset the modem. The MODEMHANG and MODEMINIT strings will be
   sent to the modem and the counter for received RINGs will be set back
   to 0.

134.    RETRIES


   RETRIES integer                                             Config & Rexx

      This specifies the numer of attempts made to get a successful
   session. A number will be removed from the callinglist if either
   the modem returns something else than BUSY after the dialstring has
   been sent or the session was successfull.

   Example: RETRIES 10

135.    REXXNAME


   REXXNAME string                                                    Config

      This specifies the name of the Rexxport. Defaults to "GOTCHA".
   For more information on Gotchas ARexx port see the ARexx chapter in
   the basics section.

   Example: REXXNAME "GOTCHA"

136.    RINGCOMMAND


   RINGCOMMAND commandstring                                   Config & Rexx

      If in answer mode this command with may contain embedded %-commands
   will be executed whenever Gotcha receives a RING from the modem.

137.    RINGINGS


   RINGINGS integer                                            Config & Rexx

      This specifies the maximum number of RINGINGS allowed for outgoing
   calls. If this number is reached Gotcha will abort the try and act
   as if DIALTIMEOUT had expired.
   Note: Not all modems support this.

   Example: RINGINGS 10

138.    RINGS


   RINGS integer                                               Config & Rexx

                                 - Page 38 -
138.    RINGS


      Specifies the number of rings needed until the MODEMANSWER string is
   sent the modem. This works only in answer mode of course.

   Example: RINGS 1

139.    RUN


   RUN cli-command                                                      Rexx

      This is the same as SPAWN except that a run is put in front of
   the command to execute. So SPAWN "run list" is the same as RUN "list".

140.    SCLEAR


   SCLEAR                                                               Rexx

   This one will clear the serial receive buffer.

141.    SCREENMODE


   SCREENMODE <mode>                                           Config & Rexx

      Specifies the screenmode Gotcha should use.

   WORKBENCH   ... open on Workbench
   CUSTOM      ... open an own (public) screen
   PUBLIC      ... if exists open on the public screen specified with the
                   CONSCREEN keyword, else open an own screen

   The resolution for screens Gotcha opens can be set with the DISPLAYID
   keyword.

   Example: SCREEMODE WORKBENCH

142.    SCREENTOBACK


   SCREENTOBACK                                                         Rexx

   Will move the Gotcha screen behind all other screens.

143.    SCREENTOFRONT


   SCREENTOFRONT                                                        Rexx

   Will move the screen Gotcha is on to the front.

144.    SERIALBAUD


   SERIALBAUD integer                                          Config & Rexx

   This is the baudrate to talk to the modem (open the serial device with).

   Example: SERIALBAUD 38400

145.    SERIALDEVICE


   SERIALDEVICE devicename                                     Config & Rexx

        If you want to use another device you can select it with this

                                 - Page 39 -
145.    SERIALDEVICE

   keyword.

   Examples: SERIALDEVICE "v34serial.device"
             SERIALDEVICE "serial.device"

146.    SERIALFLAGS


   SERIALFLAGS integer                                         Config & Rexx

      Some 3rd party serial devices need to get some flags passed when the
   device is opened.

   Example: SERIALFLAGS 0

147.    SERIALUNIT


   SERIALUNIT integer                                          Config & Rexx

      If your modem is connected to something else than unit 0 change this
   as desired.

   Example: SERIALUNIT 1

148.    SHOWREXX


   SHOWREXX yes/no                                             Config & Rexx

      Turns the display of rexxmessages on/off. If turned on rexxmessages
   will be displayed in the window and written to the logfile.

   Example: SHOWREXX YES

149.    SLINE


   SLINE                                                                Rexx

      This Rexx commands will wait for a <cr> terminated line from the modem
   and return it in the rexx variable.

   Example: SLINE

150.    SMODEM


   SMODEM string                                                        Rexx

      Sends the given string to the modem. The given string will be run
   through the modem command processor. This allows special characters
   like "|","^" and "~" (see Modem Strings).

   Example: SMODEM "~~AT~~H1~~|"

151.    SPAWNMESSAGE


   SPAWNMESSAGE text                                           Config & Rexx

      This message will ne displayed to human callers if the BBSMODE is
   SPAWN or EXIT. This cal be overridden with BBSMESSAGE.

   Example: SPAWNMESSAGE "Please press ESC twice to enter to BBS"



                                 - Page 40 -
151.    SPAWN


152.    SPAWN


   SPAWN cli-command                                                    Rexx

      If this command if received Gotcha will execute the given cli-command
   and wait until it returns.

   Example: SPAWN "echo \"Spawned from GOTCHA!\""

153.    STARTSESSION


   STARTSESSION                                                         Rexx

      When Gotcha receives this command it will start a session waiting
   for the bannerline from the remote system.

154.    STIMEOUT


   STIMEOUT seconds                                                     Rexx

      This command sets the timeout for the SLINE and SWAIT Rexx commands
   in seconds.

   Example: STIMEOUT 10

155.    STRIPDASHES


   STRIPDASHES yes/no                                          Config & Rexx

      If set to YES Gotcha will strip dashes from phonenumbers before
   they are sent to the modem. Some modems don't like dashes in
   phonenumbers.

   Example: STRIPDASHES YES

156.    SWAIT


   SWAIT text                                                           Rexx

      This Rexx only command will wait for the given text to appear at
   the serial port.
   The timout specified with STIMEOUT will be used, WARN (5) will be
   returned if the text was not received in the given time.

   Example: SWAIT "connection ok"

157.    SWEPULSE


   SWEPULSE yes/no                                             Config & Rexx

      If set to YES some special number translation for vanilla swedish
   modems will be made.

   Example: SWEPULSE NO

158.    SWRITE


   SWRITE string                                                        Rexx


                                 - Page 41 -
158.    SWRITE

      The given string will be sent to the modem without any changes.

   Example: SWRITE "Let's go"

159.    SYSOP


   SYSOP name-string                                           Config & Rexx

      Sets the name of the sysop of this node.

   Example: SYSOP "John Doe"

160.    TASKPRI


   TASKPRI priority                                            Config & Rexx

      Sets the priority of the Gotcha Task. Should only be changed to
   something else than 0 if there are problems.

   Example: TASKPRI 1

161.    TIMESTAMP


   TIMESTAMP yes/no                                            Config & Rexx

      If set to YES Gotcha will always use timestamps to convert 4D file-
   names such as 1.300.200.0.th0 to 2D filenames instead of net-node-2D
   filenames unless the remote system is a point or both systems are in
   the same net and have the same net number.

   Example: TIMESTAMP NO

162.    TURNAROUND


   TURNAROUND command                                          Config & Rexx

      This command with may include embedded %-commands will be executed
   on session turnaround. This is when sides change, receiver becomes
   sender and the other was around. This command should not take too
   long to execute since timeouts may happen, the other side might
   hang up if this takes too long.

163.    UNICONIFY


   UNICONIFY                                                            Rexx

      This ARexx only command uniconifies Gotcha. I.e. removes the
   application icon and opens Gotchas window.

164.    UNLISTEN


   UNLISTEN                                                             Rexx

      UNLISTEN is a synonym for NOLISTEN. If UNLISTEN is received Gotcha
   will not send/read any bytes to/from the modem but wait silently until
   a LISTEN or NOUNLISTEN command is received. The serial device will
   not be closed.

165.    USESYSFONT



                                 - Page 42 -
165.    USESYSFONT

   USESYSFONT yes/no                                           Config & Rexx

      If set to YES Gotcha will use the system screen font instead of the
   system default font for its screen. For windows proportional fonts
   will not be used.

   Example: USESYSFONT NO

166.    VERSION


   VERSION                                                              Rexx

      Will return the version identifier. e.g "1.2".

167.    VOICECOMMAND


   VOICECOMMAND command-string                                 Config & Rexx

      This command with may include embedded %-commands will be executed
   whenever the string specified with the MRC_VOICE keyword is received
   from the modem on an incomming or outgoing call.

   Example: VOICECOMMAND "VoiceAnswer ?incomming.txt#outgoing.txt?"

168.    VOICESTRING


   VOICESTRING string                                                   Rexx

   This is the same as MRC_VOICE.

169.    WAZOO


   WAZOO                                                                Rexx

   This is the same as NOWAZOO NO.

170.    XMAIL


   XMAIL                                                                Rexx

   This is the same as NOXMAIL NO.

171.    ZADZAP


   ZEDZAP                                                               Rexx

   This is the same as NOZEDZAP NO.

172.    ZEDZIP


   ZEDZIP                                                               Rexx

   This is the same as NOZEDZIP NO.

173.    ZMHMESSAGE


   ZHMMESSAGE text                                             Config & Rexx

      This text will be displayed to human callers if the BBSMODE is set

                                 - Page 43 -
173.    ZMHMESSAGE

   to ZMH. This can be overridden with BBSMESSAGE.

   Example: ZMHMESSAGE "Zone Mail Hour -- please call later"

































































                                 - Page 44 -
173.    ZMHMESSAGE


174.    INDEX of sections

Acknowledgements ...................................................  14. 42
ADDMONITOR .........................................................  19. 21
ADDRESS ............................................................  20. 38
AFTERSESSION .......................................................  20. 51
AKAS ...............................................................  21.  1
ALLOWREFUSING ......................................................  21. 15
ANSWER .............................................................  21. 22
ARexx ..............................................................   8. 40
AUTOSELECT .........................................................  21. 35
BACKGROUND .........................................................  21. 49
BANNER .............................................................  21. 60
Basic Information ..................................................   6.  8
BBS ................................................................  22.  4
BBSCHAR ............................................................  22. 12
BBSCOMMAND .........................................................  22. 24
BBSMESSAGE .........................................................  22. 36
BBSMODE ............................................................  22. 48
BOSSNUMBER .........................................................  23.  6
BUFFEREDLOG ........................................................  23. 22
Bug Reports ........................................................   2. 28
CALL ...............................................................  23. 37
Call Options .......................................................  10.  9
CALLERID ...........................................................  24.  4
CLOSEWINDOW ........................................................  24. 14
Commodity Info .....................................................  12. 42
Compressed Mail ....................................................  13. 36
Configuration Commands .............................................  11. 22
CONSCREEN ..........................................................  24. 21
Contact ............................................................  16. 49
CONWIN .............................................................  24. 31
COST ...............................................................  24. 40
Custom Configurations ..............................................   5. 48
CX_POPKEY ..........................................................  24. 50
CX_PRIORITY ........................................................  24. 60
Dial Scripts .......................................................   9. 29
DIALER .............................................................  25.  2
DIALPREFIX .........................................................  25. 16
DIALSUFFIX .........................................................  25. 28
DIALTIMEOUT ........................................................  25. 39
DIRECTZAP ..........................................................  25. 50
DISPLAYID ..........................................................  25. 57
Embedded Percent Commands ..........................................  11. 42
EMSI ...............................................................  26. 11
ESCAPERESETSMODEM ..................................................  26. 18
Fax and Voice ......................................................   8. 28
FAXCOMMAND .........................................................  26. 30
FAXSTRING ..........................................................  26. 42
Features ...........................................................   3. 10
Filename Bumping ...................................................  14. 27
Filenames ..........................................................  12. 60
FKEYs ..............................................................  26. 51
Flow Files .........................................................  13. 17
FORBID .............................................................  27.  0
Forbid and Pickup ..................................................   6. 31
FREQUEST ...........................................................  27. 18
GETCONFIG ..........................................................  27. 32
Gotcha Echo ........................................................   2. 50
Gotcha! v1.1 .......................................................   1.  0
HYDRA ..............................................................  27. 58
ICONIFY ............................................................  27. 65
IMMEDIATE ..........................................................  28. 11
INBOUND ............................................................  28. 25
Inbound File Tagging ...............................................  14. 13
INDIR ..............................................................  28. 32

                                 - Page 45 -
174.    INDEX of sections

Installation .......................................................   3. 31
Introduction .......................................................   2. 17
KEEP ...............................................................  28. 43
Keyboard ...........................................................   6. 54
Keywords ...........................................................  16. 66
KIWIPULSE ..........................................................  28. 57
Legal Stuff ........................................................  15. 11
Limitations ........................................................   1. 25
LISTEN .............................................................  28. 66
LOADINGMESSAGE .....................................................  29.  8
LOCATION ...........................................................  29. 17
LOG ................................................................  29. 26
LOGFILE ............................................................  29. 36
LOGLEVEL ...........................................................  29. 47
LOGLINES ...........................................................  29. 64
MINBAUD ............................................................  30. 10
Modem Strings ......................................................  12. 18
MODEMANSWER ........................................................  30. 21
MODEMDIALPOST ......................................................  30. 33
MODEMDIALPRE .......................................................  30. 40
MODEMHANG ..........................................................  30. 47
MODEMHANGUP ........................................................  30. 60
MODEMINIT ..........................................................  31.  0
MODEMRESETINTERVAL .................................................  31. 13
MODEMRESULTCODES ...................................................  31. 30
Multiple Lines .....................................................  10. 48
NAME ...............................................................  31. 23
NLDIR ..............................................................  32. 17
NOALLOWREFUSING ....................................................  32. 28
NODE ...............................................................  32. 45
Node Setup .........................................................   4. 17
Nodelist ...........................................................   5. 24
NODIRECTZAP ........................................................  32. 52
NOEMSI .............................................................  32. 62
NOESCAPERESETSMODEM ................................................  33.  7
NOFORBID ...........................................................  33. 14
NOHYDRA ............................................................  33. 23
NOKEEP .............................................................  33. 32
NOKIWIPULSE ........................................................  33. 40
NOLISTEN ...........................................................  33. 47
NONEMESSAGE ........................................................  33. 54
NORETRYHANDSHAKE ...................................................  33. 64
NOSTRIPDASHES ......................................................  34. 17
NOSWEPULSE .........................................................  34. 24
NOUNLISTEN .........................................................  34. 31
NOWAZOO ............................................................  34. 38
NOXMAIL ............................................................  34. 53
NOZEDZAP ...........................................................  34. 64
NOZEDZIP ...........................................................  35. 10
ONCLOSEWINDOW ......................................................  35. 19
OPENWINDOW .........................................................  35. 36
OUTBOUND ...........................................................  35. 47
Outbound File Tagging ..............................................  13. 60
OUTDIR .............................................................  35. 54
OwnDevUnit Library .................................................  11.  6
PASSWORD ...........................................................  35. 63
PHONENUMBER ........................................................  36. 11
PICKUP .............................................................  36. 21
Point Setup ........................................................   3. 57
QUIET ..............................................................  36. 37
QUIT ...............................................................  36. 48
REDIALDELAY ........................................................  36. 57
Registration Form ..................................................   1. 38
REMMONITOR .........................................................  37.  1
Requirements .......................................................  15.  2
RESET ..............................................................  37. 10
RETRIES ............................................................  37. 19

                                 - Page 46 -
174.    INDEX of sections

REXXNAME ...........................................................  37. 31
RINGCOMMAND ........................................................  37. 42
RINGINGS ...........................................................  37. 50
RINGS ..............................................................  37. 62
RUN ................................................................  38.  5
SCLEAR .............................................................  38. 13
SCREENMODE .........................................................  38. 20
SCREENTOBACK .......................................................  38. 37
SCREENTOFRONT ......................................................  38. 44
SERIALBAUD .........................................................  38. 51
SERIALDEVICE .......................................................  38. 60
SERIALFLAGS ........................................................  39.  4
SERIALUNIT .........................................................  39. 14
SHOWREXX ...........................................................  39. 24
SLINE ..............................................................  39. 34
SMODEM .............................................................  39. 44
SPAWN ..............................................................  39. 65
SPAWNMESSAGE .......................................................  39. 55
STARTSESSION .......................................................  40. 10
STIMEOUT ...........................................................  40. 18
STRIPDASHES ........................................................  40. 28
SWAIT ..............................................................  40. 39
SWEPULSE ...........................................................  40. 51
SWRITE .............................................................  40. 61
SYSOP ..............................................................  41.  3
TASKPRI ............................................................  41. 12
The Menu ...........................................................   7. 28
The Modem ..........................................................   4. 52
TIMESTAMP ..........................................................  41. 22
TURNAROUND .........................................................  41. 34
UNICONIFY ..........................................................  41. 45
UNLISTEN ...........................................................  41. 53
USESYSFONT .........................................................  41. 63
VERSION ............................................................  42.  7
VOICECOMMAND .......................................................  42. 14
VOICESTRING ........................................................  42. 25
WAZOO ..............................................................  42. 32
XMAIL ..............................................................  42. 39
ZADZAP .............................................................  42. 46
ZEDZIP .............................................................  42. 53
ZMHMESSAGE .........................................................  42. 60

175.    INDEX of keywords

Acknowledgements       .............................................   1. 23
ADDMONITOR .........................................................  17.  4
ADDRESS ............................................................   8.  6
AFTERSESSION .......................................................   5. 66
AKAS ...............................................................   8.  6
ALLOWREFUSING ......................................................  17.  8
ANSWER .............................................................   7. 43
ANSWER = YES .......................................................   4. 22
ARexx ..............................................................   6. 16
ARexx chapter ......................................................  37. 38
AUTOSELECT .........................................................  17. 10
BACKGROUND .........................................................  17. 11
BANNER .............................................................  17. 12
Basic Information      .............................................   1. 16
BBS ................................................................  17. 13
BBSCHAR ............................................................  17. 14
BBSCOMMAND .........................................................  17. 15
BBSMESSAGE .........................................................  17. 16
BBSMODE ............................................................  17. 17
BOSSNUMBER .........................................................  17. 18
BUFFEREDLOG ........................................................  17. 19
Bug Reports            .............................................   1. 22
CALL ...............................................................   4. 35

                                 - Page 47 -
175.    INDEX of keywords

Call options .......................................................   6. 18
CALLERID ...........................................................  17. 21
CLOSEWINDOW ........................................................  17. 22
Commodity Infos ....................................................   6. 24
Compressed Mail files ..............................................   6. 27
Config Commands ....................................................   6. 21
CONSCREEN ..........................................................  17. 23
Contact the author     .............................................   1. 20
CONWIN .............................................................  17. 24
COST ...............................................................  17. 25
Custom Configs .....................................................   2. 27
CX_POPKEY ..........................................................  12. 45
CX_PRIORITY ........................................................  12. 46
Dial Scripts .......................................................   6. 17
DIALER .............................................................  17. 28
DIALPREFIX .........................................................  17. 29
DIALSUFFIX .........................................................  12. 21
DIALTIMEOUT ........................................................  17. 31
DIRECTZAP ..........................................................  17. 32
DISPLAYID ..........................................................  17. 33
Embedded %-commands ................................................   6. 22
EMSI ...............................................................  17. 34
ESCAPERESETSMODEM ..................................................  17. 35
extra section ......................................................   9.  2
Fax and Voice ......................................................   6. 15
FAXCOMMAND .........................................................   8. 36
FAXSTRING ..........................................................  17. 37
Features ...........................................................   2. 21
Filename bumping ...................................................   6. 30
Filenames ..........................................................   6. 25
FKEY and SFKEY .....................................................   7. 22
FKEY1, FKEY2, etc ..................................................   8. 21
FKEYs ..............................................................  17. 38
Flow Files .........................................................   6. 26
FORBID .............................................................   6. 46
Forbid and Pickup ..................................................   6. 12
FORBID<what> .......................................................  33. 22
FORBIDALL ..........................................................  17. 39
FORBIDFREQ .........................................................  17. 40
FORBIDXMAIL ........................................................  17. 41
FREQUEST ...........................................................  17. 42
GETCONFIG ..........................................................   9.  5
HYDRA ..............................................................  17. 44
ICONIFY ............................................................  17. 45
IMMEDIATE ..........................................................  17. 46
INBOUND ............................................................  17. 47
Inbound file tagging ...............................................   6. 29
INDIR ..............................................................  17. 48
Installation .......................................................   2. 22
Introduction           .............................................   1. 15
KEEP<what> .........................................................  33. 39
KEEPALL ............................................................  17. 49
KEEPXMAIL ..........................................................  17. 50
keyword index ......................................................  11. 27
keywords ...........................................................   7. 27
Keywords               .............................................   1. 17
KIWIPULSE ..........................................................  17. 51
Legal stuff            .............................................   1. 21
Limitations            .............................................   1. 14
LISTEN .............................................................  17. 52
LOADINGMESSAGE .....................................................  17. 53
LOCATION ...........................................................  17. 54
LOG ................................................................  17. 55
LOGFILE ............................................................  17. 56
LOGLEVEL ...........................................................  17. 57
LOGLINES ...........................................................  17. 58
MINBAUD ............................................................  17. 59

                                 - Page 48 -
175.    INDEX of keywords

Modem strings ......................................................   6. 23
MODEMANSWER ........................................................   7. 35
MODEMDIALPOST ......................................................  17. 61
MODEMDIALPRE .......................................................  17. 62
MODEMHANG ..........................................................  12. 21
MODEMHANGUP ........................................................  17. 64
MODEMINIT ..........................................................   7. 39
MODEMRESETINTERVAL .................................................  17. 66
MRC_BUSY ...........................................................  18.  0
MRC_CARRIER ........................................................  18.  1
MRC_CONNECT ........................................................  18.  2
MRC_FAX ............................................................  18.  3
MRC_FAX and MRC_VOICE ..............................................   8. 35
MRC_NOANSWER .......................................................  18.  4
MRC_NOCARRIER ......................................................  18.  5
MRC_NODIALTONE .....................................................  18.  6
MRC_RING ...........................................................  18.  7
MRC_RINGING ........................................................  18.  8
MRC_VOICE ..........................................................  18.  9
Multiple Lines .....................................................   6. 19
NAME ...............................................................  18. 10
NLDIR ..............................................................   4. 24
NOALLOWREFUSING ....................................................  18. 12
NODE ...............................................................  18. 14
Node Setup .........................................................   2. 24
NODELIST ...........................................................  18. 13
NODIRECTZAP ........................................................  18. 15
NOEMSI .............................................................   5. 58
NOESCAPERESETSMODEM ................................................  18. 17
NOFORBIDALL ........................................................  18. 18
NOFORBIDFREQ .......................................................  18. 19
NOFORBIDXMAIL ......................................................  18. 20
NOHYDRA ............................................................  18. 21
NOKEEPALL ..........................................................  18. 22
NOKEEPXMAIL ........................................................  18. 23
NOKIWIPULSE ........................................................  18. 24
NOLISTEN ...........................................................  18. 25
NONEMESSAGE ........................................................  18. 26
NORETRYHANDSHAKE ...................................................   4. 46
NOSTRIPDASHES ......................................................  18. 28
NOSWEPULSE .........................................................  18. 29
NOUNLISTEN .........................................................  18. 30
NOWAZOO ............................................................  18. 31
NOXMAIL ............................................................  18. 32
NOZEDZAP ...........................................................  18. 33
NOZEDZIP ...........................................................  18. 34
ONCLOSEWINDOW ......................................................  18. 35
OPENWINDOW .........................................................  18. 36
OUTBOUND ...........................................................  18. 37
Outbound file tagging ..............................................   6. 28
OUTDIR .............................................................  18. 38
OwnDevUnit Library .................................................   6. 20
PASSWORD ...........................................................  18. 39
PHONENUMBER ........................................................  18. 40
PICKUP .............................................................   6. 40
Point Setup ........................................................   2. 23
QUIET ..............................................................  18. 42
QUIT ...............................................................  18. 43
REDIALDELAY ........................................................   4. 41
Registration Form      .............................................   1. 24
REMMONITOR .........................................................  18. 45
Requirements           .............................................   1. 13
RESET ..............................................................  18. 46
RETRIES ............................................................   4. 43
RETRYDELAY .........................................................  10. 34
returncodes ........................................................   4. 56
REXXNAME ...........................................................   8. 51

                                 - Page 49 -
175.    INDEX of keywords

RING ...............................................................  37. 17
RINGCOMMAND ........................................................  18. 49
RINGINGS ...........................................................  18. 50
RINGS ..............................................................  18. 51
RUN ................................................................  18. 52
SCLEAR .............................................................  18. 53
SCREENMODE .........................................................  18. 54
SCREENTOBACK .......................................................  18. 55
SCREENTOFRONT ......................................................  18. 56
SERIALBAUD .........................................................  18. 57
SERIALDEVICE .......................................................  18. 58
SERIALFLAGS ........................................................  18. 59
SERIALUNIT .........................................................  18. 60
SFKEY1, SFKEY2, etc ................................................   8. 26
SFKEYs .............................................................  18. 61
SHOWREXX ...........................................................   7. 37
SLINE ..............................................................  18. 63
SMODEM .............................................................  18. 64
SPAWN ..............................................................  18. 66
SPAWNMESSAGE .......................................................  18. 65
special modem characters ...........................................  25. 24
STARTSESSION .......................................................  19.  0
STIMEOUT ...........................................................  19.  1
STRIPDASHES ........................................................  19.  2
SWAIT ..............................................................  19.  3
SWEPULSE ...........................................................  19.  4
SWRITE .............................................................  19.  5
SYSOP ..............................................................   8.  6
TASKPRI ............................................................  19.  7
The Keyboard .......................................................   6. 13
The Menu ...........................................................   6. 14
The Modem ..........................................................   2. 25
The Nodelist .......................................................   2. 26
The Support Echo       .............................................   1. 19
TIMESTAMP ..........................................................  19.  8
TURNAROUND .........................................................  19.  9
UNICONIFY ..........................................................  19. 10
UNLISTEN ...........................................................  19. 11
USESYSFONT .........................................................  19. 12
VERSION ............................................................  19. 13
VOICECOMMAND .......................................................   8. 36
VOICESTRING ........................................................  19. 15
WAZOO ..............................................................  19. 16
XMAIL ..............................................................  19. 17
ZEDZAP .............................................................  19. 18
ZEDZIP .............................................................  19. 19
ZHMMESSAGE .........................................................  22. 42
ZMHMESSAGE .........................................................  19. 20